home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / dviselect.man < prev    next >
Encoding:
Text File  |  1989-10-03  |  4.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. DVISELECT                 User Commands                 DVISELECT
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      dviselect - extract pages from DVI files
  10.  
  11. SSYYNNOOPPSSIISS
  12.      ddvviisseelleecctt [ --ss ] [ --ii _i_n_f_i_l_e ] [ --oo _o_u_t_f_i_l_e ] _l_i_s_t _o_f _p_a_g_e_s
  13.      [ _i_n_f_i_l_e [ _o_u_t_f_i_l_e ] ]
  14.  
  15. DDEESSCCRRIIPPTTIIOONN
  16.      _D_v_i_s_e_l_e_c_t selects pages from a DVI file produced by TeX,
  17.      creating a new DVI file usable by any of TeX's conversion
  18.      program (e.g., iptex), or even by dviselect itself.
  19.  
  20.      A _r_a_n_g_e is a string of the form _f_i_r_s_t:_l_a_s_t where both _f_i_r_s_t
  21.      and _l_a_s_t are optional numeric strings, with negative numbers
  22.      indicated by a leading underscore character ``_''.  If both
  23.      _f_i_r_s_t and _l_a_s_t are omitted, the colon may also be omitted,
  24.      or may be replaced with an asterisk ``*''.  A _p_a_g_e _r_a_n_g_e is
  25.      a list of ranges separated by periods.  A _l_i_s_t _o_f _p_a_g_e_s is
  26.      described by a set of page ranges separated by commas and/or
  27.      white space.
  28.  
  29.      _D_v_i_s_e_l_e_c_t actually looks at the ten _c_o_u_n_t variables that TeX
  30.      writes; the first of these (\count0) is the page number,
  31.      with \count1 through \count9 having varied uses depending on
  32.      which macro packages are in use.  (Typically \count1 is a
  33.      chapter or section number.)  A page is included in
  34.      _d_v_i_s_e_l_e_c_t's output if all its \count values are within any
  35.      one of the ranges listed on the command line.  For example,
  36.      the command ``dviselect *.1,35:'' might select everything in
  37.      chapter 1, as well as pages 35 and up.  ``dviselect 10:30''
  38.      would select pages 10 through 30 (inclusive).  ``:43'' means
  39.      everything up to and including page 43 (including negative-
  40.      numbered pages).  If a Table of Contents has negative page
  41.      numbers, ``:_1'' will select it.  ``*.4 .........1'' might
  42.      mean everything in every chapter 4 and an index, presuming
  43.      \count9 was set to 1 in the index.  (``*'' must be quoted
  44.      from the shell; the null string is more convenient to use,
  45.      if harder to read.)
  46.  
  47.      Instead of \count values, _d_v_i_s_e_l_e_c_t can also select by
  48.      ``absolute page number'', where the first page is page 1,
  49.      the second page 2, and so forth.  Absolute page numbers are
  50.      indicated by a leading equal sign ``=''.  Ranges of absolute
  51.      pages are also allowed: ``dviselect =3:7'' will extract the
  52.      third through seventh pages.  Dot separators are not legal
  53.      in absolute ranges, and there are no negative absolute page
  54.      numbers.
  55.  
  56.      More precisely, an asterisk or a null string implies no
  57.      limit; an equal sign means absolute pages rather than
  58.      \counts; a leading colon means everything up to and includ-
  59.      ing the given page; a trailing colon means everything from
  60.  
  61.  
  62.  
  63. Sprite v1.0                                                     1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DVISELECT                 User Commands                 DVISELECT
  71.  
  72.  
  73.  
  74.      the given page on; and a period indicates that the next
  75.      \count should be examined.  If fewer than 10 ranges are
  76.      specified, the remaining \counts are left unrestricted (that
  77.      is, ``1:5'' and ``1:5.*'' are equivalent).  A single number
  78.      _n is treated as if it were the range _n:_n.  An arbitrary
  79.      number of page selectors may be given, separated by commas
  80.      or whitespace; a page is selected if any of the selectors
  81.      matches its \counts or absolute page number.
  82.  
  83.      Dviselect normally prints the page numbers of the pages
  84.      selected; the -_s option suppresses this.
  85.  
  86. AAUUTTHHOORR
  87.      Chris Torek, University of Maryland
  88.  
  89. SSEEEE AALLSSOO
  90.      dvipr(1), iptex(1), tex(1), _T_h_e _T_e_X_b_o_o_k
  91.  
  92. BBUUGGSS
  93.      A leading ``-'' ought to be allowed for negative numbers,
  94.      but it is currently used as a synonym for ``:'', for back-
  95.      wards compatibility.
  96.  
  97.      Section or subsection selection will sometimes fail, for the
  98.      DVI file lists only the \count values that were active when
  99.      the page ended.  Clever macro packages can alleviate this by
  100.      making use of other ``free'' \count registers.  Chapters
  101.      normally begin on new pages, and do not suffer from this
  102.      particular problem.
  103.  
  104.      _D_v_i_s_e_l_e_c_t does not adjust the parameters in the postamble;
  105.      however, since these values are normally used only to size
  106.      certain structures in the output conversion programs, and
  107.      the parameters never need to be adjusted upward, this has
  108.      not proven to be a problem.
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Sprite v1.0                                                     2
  130.  
  131.  
  132.  
  133.